/**
 * Copyright (C) 2013-2014 the original author or authors.
 */
package com.foreveross.bsl.mam.app.application;

import java.util.List;

import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;
import javax.ws.rs.core.MediaType;

import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;

import com.foreveross.bsl.mam.app.application.vo.SettingCategoryVo;

/**
 * @description 系统设置接口定义类
 * 
 * @author TANZHIXIONG
 * @version v1.0
 * 
 * @2013-6-21
 * 
 */
@Path(value = "/setting")
public interface SettingCategoryApplication {

	/**
	 * 此方法描述的是：保存一个 应用类别 实体对象
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:10:48
	 */
	@POST
	@Path("/add")
	@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
	public SettingCategoryVo saveEntity(SettingCategoryVo entity);

	/**
	 * 此方法描述的是：更新一个 应用类别 实体对象
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:10:31
	 */
	@PUT
	@Path("/update")
	@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
	public SettingCategoryVo updateEntity(SettingCategoryVo entity);

	/**
	 * 此方法描述的是：根据id删除一条记录
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:10:14
	 */
	@DELETE
	@Path("/delete/{id}")
	@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
	public void deleteEntity(@PathParam("id") String id);

	/**
	 * 此方法描述的是：根据id查询一条记录  应用类别 
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:09:57
	 */
	@GET
	@Path("/get/{id}")
	@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
	public SettingCategoryVo getEntity(@PathParam("id") String id);

	/**
	 * 此方法描述的是：查询所有 应用类别 记录 
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:09:48
	 */
	@POST
	@Path("/findAll")
	@Produces({ MediaType.APPLICATION_JSON })
	@Consumes({ MediaType.APPLICATION_JSON })
	public Page<SettingCategoryVo> findByPageable(@QueryParam("type") String type, Pageable pageable);

	/**
	 * 此方法描述的是：根据类型和有效标识查询  应用类别 
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:09:01
	 */
	@GET
	@Path("/findByType")
	@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
	public List<SettingCategoryVo> findByType(@QueryParam("type") String type,
			@QueryParam("available") String available);

	/**
	 * 此方法描述的是：根据id查询一条记录
	 * 
	 * @author: panhm@foreveross.com
	 * @version: 2013-7-24 下午4:09:57
	 */
	@GET
	@Path("/checkName")
	@Produces({ MediaType.APPLICATION_XML, MediaType.APPLICATION_JSON })
	public SettingCategoryVo checkName(@QueryParam("name") String name,
			@QueryParam("type") String type);
}
